package com.netdisk.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.netdisk.entity.UserActivity;

import java.util.List;

/**
 * 用户活动日志服务接口
 */
public interface UserActivityService extends IService<UserActivity> {

    /**
     * 获取用户最近活动日志
     *
     * @param userId 用户ID
     * @param limit 最大记录数
     * @return 活动日志列表
     */
    List<UserActivity> getRecentActivities(Integer userId, Integer limit);

    /**
     * 记录用户活动
     *
     * @param userId 用户ID
     * @param fileId 文件ID (可选，可以为null)
     * @param fileName 文件名称 (可选，可以为null)
     * @param actionType 操作类型
     * @param description 描述
     * @param ipAddress IP地址 (可选，可以为null)
     * @param userAgent 用户代理 (可选，可以为null)
     * @return 是否记录成功
     */
    boolean recordActivity(Integer userId, Integer fileId, String fileName, 
                         String actionType, String description, 
                         String ipAddress, String userAgent);
} 